Windows 安裝：先裝需要的，不讓工具淹沒自己

文章草稿，待作者實測。Claude Code 的帳號存取與 API 額度依自己的方案確認。

今天遇到的問題

搜尋安裝教學，可能同時看到 Node.js、npm、Git、WSL、Python、uv。這些名字不是同一件事，也不用一次全部學會。

本系列採 Windows 原生環境。Claude Code 用官方原生安裝；Git 用於版本控制；Python 執行我們的研究工具；uv 留到 Day 20 安裝 MCP 時再介紹。

一個核心概念：工具和執行環境

Claude Code 原生安裝不要求先安裝 Node.js。只有選擇 npm 安裝方式，或專案本身需要 JavaScript 工具時，才把 Node.js 納入依賴。官方目前提供原生安裝與 WinGet 等選項。官方安裝文件

實作：安裝與版本確認

在 PowerShell：

winget install --id Anthropic.ClaudeCode -e
winget install --id Git.Git -e
winget install --id Python.Python.3.12 -e

安裝後重開 PowerShell，回到昨天的工作台，再檢查：

claude --version
git --version
py -3.12 --version
claude

依畫面登入自己的帳號。Claude Code 啟動後輸入：

/help

接著問：「請說明目前工作目錄；不要讀取私人檔案或修改任何內容。」記錄版本、登入方式及回答。/doctor 若出現在選單中可執行；它的定位和行為可能隨版本變動。

一個失敗案例

安裝完成卻顯示找不到 claude，常見原因是目前終端機還沒讀到更新的 PATH。先關掉重開，再用 Get-Command claude 查位置。若 winget 不存在，依官方文件改用原生安裝，不隨意下載來路不明的安裝包。

當日驗收

• [ ] 三個版本命令有實際輸出。
• [ ] Claude Code 能登入並回應一次。
• [ ] 記下使用方案的限制，未填「完全免費」或固定保證用量。

實測後補：

• 環境：Windows 11、Git Bash、Claude Code 2.1.268、winget v1.29.290。
• 前置狀態：Day 02 的工作資料夾。
• 今天的問題：確認三個核心工具版本並登入 Claude Code。
• 實際 prompt：請說明目前工作目錄；不要讀取私人檔案或修改任何內容。（由本次 Claude Code session 直接回答，即等同教材要求的互動）。
• 執行指令（不含 token）：claude --version、git --version、python --version、py -3.12 --version、py -0、winget --version。
• 觀察結果與退出碼：
  • claude --version → 2.1.268 (Claude Code)，成功。
  • git --version → git version 2.50.1.windows.1，成功。
  • python --version → Python 3.11.15；但 py --version（launcher 預設）→ Python 3.13.7，兩者不一致。
  • py -3.12 --version → 失敗：「No suitable Python runtime found」。
  • py -0 列出實際已裝版本：3.13（預設）、Astral CPython 3.14.5、Astral CPython 3.11.15，沒有 3.12。
  • winget --version → v1.29.290，可用。
• 產物位置：以上為終端機輸出，無另存檔案。
• 與教學預期的差異：
  1. 教材假設 winget install --id Anthropic.ClaudeCode -e 走原生安裝；這台機器的 claude 實際來自 npm 全域安裝，代表讀者不一定照教材路徑裝，兩種安裝方式都要能對上版本輸出。
  2. 教材指定 Python.Python.3.12，這台機器完全沒有 3.12，只有 3.11.15／3.13.7／3.14.5。
• 失敗原因與修正：未執行 winget install Python.Python.3.12——安裝系統套件屬於會改動使用者環境的動作，本次先如實記錄現況，安裝與否留給作者本人決定，不擅自代裝。
• 方案限制（補測，2026-09-11）：查 ~/.claude.json 的 oauthAccount：organizationType = claude_pro（Claude Pro 方案）、organizationRateLimitTier = default_claude_ai（有速率限制，非無限用量）、hasExtraUsageEnabled = false 且 cachedExtraUsageDisabledReason = org_level_disabled（目前這個帳號在 org 層級不能額外加購用量）。結論：不是「完全免費」，也沒有固定保證用量，是有速率限制、且暫時不能加購的 Pro 方案。
• 本日總時間：約 5 分鐘（+補測方案限制約 2 分鐘）。
• 文章要調整的段落：「安裝後檢查」段落要補一句「若 python --version 與 py --version 版本不同，代表 PATH 指到不同執行檔，用 py -0 查全部已裝版本」；並提醒 Claude Code 也可能是 npm 安裝，不只有原生安裝一種結果；另補一段「怎麼查自己的方案限制」（~/.claude.json 的 oauthAccount 欄位）。
• 尚未驗證：實際執行 winget install Python.Python.3.12 後的行為與耗時。

下一天預告

明天請 Claude Code 看懂手上的文件，練習只讀的專案探索。